"h#dZddlmZddlmZddlmZmZmZm Z ddl m Z m Z ddl mZddlmZdd lmZmZgd ZGd d Zedd ZGddZGddZGddeZGddZGddZy)ze Helpers to test your application's logging behavior. .. versionadded:: 20.1.0 See :doc:`testing`. ) annotations)contextmanager)Any Generator NamedTupleNoReturn) configure get_config)map_method_name) DropEvent) EventDict WrappedLogger) CapturedCallCapturingLoggerCapturingLoggerFactory LogCapture ReturnLoggerReturnLoggerFactory capture_logsc<eZdZUdZded<ddZ ddZy) ra Class for capturing log messages in its entries list. Generally you should use `structlog.testing.capture_logs`, but you can use this class if you want to capture logs with other patterns. :ivar List[structlog.typing.EventDict] entries: The captured log entries. .. versionadded:: 20.1.0 .. versionchanged:: 24.3.0 Added mapping from "exception" to "error" Added mapping from "warn" to "warning" zlist[EventDict]entriescg|_yN)rselfs N/var/www/html/sandstorm/venv/lib/python3.12/site-packages/structlog/testing.py__init__zLogCapture.__init__5s  c`t||d<|jj|t)N log_level)r rappendr )r_ method_name event_dicts r__call__zLogCapture.__call__8s*#2+"> ; J'rNreturnNone)r#rr$strr%rr(r__name__ __module__ __qualname____doc____annotations__rr&rrrr$s9 -0>G rrc#Kt}td}|j} |j|j |t ||j |j|j|t |y#|j|j|t |wxYww)a Context manager that appends all logging statements to its yielded list while it is active. Disables all configured processors for the duration of the context manager. Attention: this is **not** thread-safe! .. versionadded:: 20.1.0 processors)r3N)rr copyclearr"r rextend)capr3old_processorss rrrAs ,Cl+J__&N )#Z(kk .)Z( .)Z(s(C;B&.C/CCcDeZdZdZddZexZxZxZxZZ exZ xZ xZ xZ xZZy)raU Return the arguments that it's called with. >>> from structlog import ReturnLogger >>> ReturnLogger().info("hello") 'hello' >>> ReturnLogger().info("hello", when="again") (('hello',), {'when': 'again'}) .. versionchanged:: 0.3.0 Allow for arbitrary arguments and keyword arguments to be passed in. c4t|dk(r|s|dS||fS)zY Return tuple of ``args, kw`` or just ``args[0]`` if only one arg passed r r)len)rargskws rmsgzReturnLogger.msgms# t9>"7NRxrN)r<rr=rr(r)r,r-r.r/r>logdebuginfowarnwarningfatalfailureerrerrorcritical exceptionr1rrrr_sE +.-C-%-$-;>>E>G>c>E>Hyrrc eZdZdZddZddZy)rz Produce and cache `ReturnLogger`\ s. To be used with `structlog.configure`\ 's *logger_factory*. Positional arguments are silently ignored. .. versionadded:: 0.4.0 c"t|_yr)r_loggerrs rrzReturnLoggerFactory.__init__s #~ rc|jSr)rLrr<s rr&zReturnLoggerFactory.__call__s ||rNr')r<rr(r)r,r-r.r/rr&r1rrrr{s&rrc0eZdZUdZded<ded<ded<y) ra A call as captured by `CapturingLogger`. Can also be unpacked like a tuple. Args: method_name: The method name that got called. args: A tuple of the positional arguments. kwargs: A dict of the keyword arguments. .. versionadded:: 20.2.0 r*r$ztuple[Any, ...]r<zdict[str, Any]kwargsN)r,r-r.r/r0r1rrrrs   rrc4eZdZUdZded<ddZd dZd dZy) rz Store the method calls that it's been called with. This is nicer than `ReturnLogger` for unit tests because the bound logger doesn't have to cooperate. **Any** method name is supported. .. versionadded:: 20.2.0 zlist[CapturedCall]callscg|_yr)rRrs rrzCapturingLogger.__init__s  rc4dt|jdS)Nz)r;rRrs r__repr__zCapturingLogger.__repr__s'DJJ'8 BBrcdfd }|S)z) Capture call to `calls` cRjjt||yr)rRr"r)r<r=namers rr?z(CapturingLogger.__getattr__..logs JJ  l4r: ;r)r<rr=rr(r)r1)rrXr?s`` r __getattr__zCapturingLogger.__getattr__s  < rNr')r(r*)rXr*r(r)r,r-r.r/r0rrUrYr1rrrrs  Crrc,eZdZUdZded<ddZddZy) ra0 Produce and cache `CapturingLogger`\ s. Each factory produces and reuses only **one** logger. You can access it via the ``logger`` attribute. To be used with `structlog.configure`\ 's *logger_factory*. Positional arguments are silently ignored. .. versionadded:: 20.2.0 rloggerc"t|_yr)rr[rs rrzCapturingLoggerFactory.__init__s %' rc|jSr)r[rNs rr&zCapturingLoggerFactory.__call__s {{rNr')r<rr(rr+r1rrrrs  (rrN)r(z&Generator[list[EventDict], None, None])r/ __future__r contextlibrtypingrrrr_configr r _log_levelsr exceptionsr rr__all__rrrrrrrr1rrres} #%77*(!, :)):??8$:*>r