o hr@sdZddlmZddlmZddlmZmZmZm Z ddl m Z m Z ddl mZddlmZmZgd ZGd d d ZedddZGdddZGdddZGdddeZGdddZGdddZdS)ze Helpers to test your application's logging behavior. .. versionadded:: 20.1.0 See :doc:`testing`. ) annotations)contextmanager)Any Generator NamedTupleNoReturn) configure get_config) DropEvent) EventDict WrappedLogger) CapturedCallCapturingLoggerCapturingLoggerFactory LogCapture ReturnLoggerReturnLoggerFactory capture_logsc@s.eZdZUdZded<dddZdddZdS)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 zlist[EventDict]entriesreturnNonecC g|_dSN)rselfrG/var/www/html/ai/venv/lib/python3.10/site-packages/structlog/testing.py__init__0 zLogCapture.__init___r method_namestr event_dictr rcCs||d<|j|t)N log_level)rappendr )rr r!r#rrr__call__3s zLogCapture.__call__Nrr)r r r!r"r#r rr__name__ __module__ __qualname____doc____annotations__rr&rrrrr#s  rr&Generator[list[EventDict], None, None]c cst}td}|}z#|||t|d|jVW|||t|ddS|||t|dw)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)r/N)rr copyclearr%r rextend)capr/old_processorsrrrr<s       rc@sFeZdZdZd ddZeZZZZZ eZ Z Z Z ZZdS) 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. argsrkwrcOs t|dkr |s |dS||fS)zY Return tuple of ``args, kw`` or just ``args[0]`` if only one arg passed rr)len)rr5r6rrrmsghszReturnLogger.msgN)r5rr6rrr)r)r*r+r,r8logdebuginfowarnwarningfatalfailureerrerrorcritical exceptionrrrrrZs   rc@s$eZdZdZd ddZd d d Zd S)rz Produce and cache `ReturnLogger`\ s. To be used with `structlog.configure`\ 's *logger_factory*. Positional arguments are silently ignored. .. versionadded:: 0.4.0 rrcC t|_dSr)r_loggerrrrrr zReturnLoggerFactory.__init__r5rrcG|jSr)rErr5rrrr&zReturnLoggerFactory.__call__Nr')r5rrr)r)r*r+r,rr&rrrrrvs rc@s*eZdZUdZded<ded<ded<dS) ra% A call as captured by `CapturingLogger`. Can also be unpacked like a tuple. Arguments: 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, ...]r5zdict[str, Any]kwargsN)r)r*r+r,r-rrrrrs  rc@s8eZdZUdZded<dddZdd d Zdd dZdS)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]callsrrcCrr)rKrrrrrrzCapturingLogger.__init__r"cCsdt|jdS)Nz)r7rKrrrr__repr__szCapturingLogger.__repr__namercsd fdd }|S) z) Capture call to `calls` r5rr6rrcsjt||dSr)rKr%r)r5r6rMrrrr9sz(CapturingLogger.__getattr__..logN)r5rr6rrrr)rrMr9rrNr __getattr__szCapturingLogger.__getattr__Nr')rr")rMr"rr)r)r*r+r,r-rrLrOrrrrrs   rc@s.eZdZUdZded<d ddZdd d Zd S)ra1 Produce and cache `CapturingLogger`\ s. Each factory produces and re-uses 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 rloggerrrcCrDr)rrPrrrrrrFzCapturingLoggerFactory.__init__r5rcGrGr)rPrHrrrr&rIzCapturingLoggerFactory.__call__Nr')r5rrrr(rrrrrs  rN)rr.)r, __future__r contextlibrtypingrrrr_configr r exceptionsr r r __all__rrrrrrrrrrrs