"h^dZddlmZddlZddlZddlZddlmZddlm Z ddl m Z ddl m Z mZmZmZmZmZmZmZmZdd lmZdd lmZdd l mZmZmZmZ ddlZ ddl Z ddl!Z!dd l"m#Z#dd l$m%Z%gdZ&ejNdk(Z(dZ)dZ*d2dZ+eejXjZZ-ejXj\Z.ejXj^Z/ej`jbZ1ej`jdZ2ej`jfZ3ej`jhZ4ej`jjZ5ej`jlZ6ejnjbZ8ndZ-dZ.dZ/dZ1dZ2dZ3dZ4dZ5dZ6dZ8e( xseduZ9e9Z:GddeZ;ee;ee;fZ<Gdd Z=Gd!d"Z>Gd#d$eZ?eGd%d&Z@eGd'd(ZAGd)d*ZBeCZDd3d+ZEeGd,d-ZFeFZG d3d.ZHe!eGZIne eHZIneEZIGd/d0ZJeCZK d4d1ZLy#e$rdZYwxYw#e$rdZ YwxYw#e$rdZ!YwxYw)5zz Helpers that make development with *structlog* more pleasant. See also the narrative documentation in `console-output`. ) annotationsN) dataclass)StringIO) ModuleType) AnyCallableLiteralProtocolSequenceTextIOTypeUnioncast)_format_exception)_figure_out_exc_info) EventDictExceptionRendererExcInfo WrappedLogger)Console) Traceback)ConsoleRendererRichTracebackFormatterbetter_tracebackplain_tracebackrich_tracebackwin32z1{who} requires the {package} package installed. cB|t|z }|dtd|zzS)z& Pads *s* to length *length*.  r)lenmax)slengthmissings J/var/www/html/sandstorm/venv/lib/python3.12/site-packages/structlog/dev.py_padr(Fs's1voG sc!Wo& &&zzzzzzzzzzceZdZUded<ded<ded<ded<ded<ded<ded<ded <ded <ded <ded <ded <ded<y)_Stylesstrresetbrightlevel_criticallevel_exception level_error level_warn level_info level_debug level_notset timestamp logger_namekv_keykv_valueN)__name__ __module__ __qualname____annotations__r)r'r+r+psI J KOON KMr)r+c@eZdZeZeZeZeZ eZ e Z e Ze ZeZeZeZeZeZy)_ColorfulStylesN)r:r;r< RESET_ALLr-BRIGHTr.REDr/r0r1YELLOWr2GREENr3r4RED_BACKr5DIMr6BLUEr7CYANr8MAGENTAr9r>r)r'r@r@sC E FNOKJJKLIK FHr)r@c@eZdZdZdZdZdZdZdZdZ dZ dZ dZ dZ dZdZy) _PlainStylesN)r:r;r<r-r.r/r0r1r2r3r4r5r6r7r8r9r>r)r'rLrLsC E FNOKJJKLIK FHr)rLceZdZdZddZy)ColumnFormatterz :class:`~typing.Protocol` for column formatters. See `KeyValueColumnFormatter` and `LogLevelColumnFormatter` for examples. .. versionadded:: 23.3.0 cy)aK Format *value* for *key*. This method is responsible for formatting, *key*, the ``=``, and the *value*. That means that it can use any string instead of the ``=`` and it can leave out both the *key* or the *value*. If it returns an empty string, the column is omitted completely. Nr>)selfkeyvalues r'__call__zColumnFormatter.__call__sr)NrRr,rSobjectreturnr,)r:r;r<__doc__rTr>r)r'rOrOs   r)rOc&eZdZUdZded<ded<y)Columna A column defines the way a key-value pair is formatted, and, by it's position to the *columns* argument of `ConsoleRenderer`, the order in which it is rendered. Args: key: The key for which this column is responsible. Leave empty to define it as the default formatter. formatter: The formatter for columns with *key*. .. versionadded:: 23.3.0 r,rRrO formatterN)r:r;r<rXr=r>r)r'rZrZs  Hr)rZcleZdZUdZded<ded<ded<ded<d Zd ed <d Zded <d Zded<ddZy)KeyValueColumnFormattera Format a key-value pair. Args: key_style: The style to apply to the key. If None, the key is omitted. value_style: The style to apply to the value. reset_style: The style to apply whenever a style is no longer needed. value_repr: A callable that returns the string representation of the value. width: The width to pad the value to. If 0, no padding is done. prefix: A string to prepend to the formatted key-value pair. May contain styles. postfix: A string to append to the formatted key-value pair. May contain styles. .. versionadded:: 23.3.0 str | None key_styler, value_style reset_stylezCallable[[object], str] value_reprrintwidthrMprefixpostfixct}|jr6|j|j|j|j|jX|j|j|j||j|j|jd|j|j |jt |j||j|j|j|jr6|j|j|j|j|jS)N=) rrewriterar_r`r(rbrdrfgetvalue)rQrRrSsios r'rTz KeyValueColumnFormatter.__call__sj ;; IIdkk " IId&& ' >> % IIdnn % IIcN IId&& ' IIcN $""# $tu-tzz:; $""# << IIdll # IId&& '||~r)NrU) r:r;r<rXr=rdrerfrTr>r)r'r]r]sC4''E3NFCGSr)r]cReZdZUdZded<ded<ded< d d d Zd d Zy)LogLevelColumnFormattera Format a log level according to *level_styles*. The width is padded to the longest level name (if *level_styles* is passed -- otherwise there's no way to know the lengths of all levels). Args: level_styles: A dictionary of level names to styles that are applied to it. If None, the level is formatted as a plain ``[level]``. reset_style: What to use to reset the style after the level name. Ignored if if *level_styles* is None. width: The width to pad the level to. If 0, no padding is done. .. versionadded:: 23.3.0 .. versionadded:: 24.2.0 *width* dict[str, str] | None level_stylesr,rarcrdNc||_|rC|dk(rdn.tt|jjd|_||_yd|_d|_y)Nrct|SNr"es r'z2LogLevelColumnFormatter.__init__..4s SVr)rRrM)ror"r#keysrdra)rQrorards r'__init__z LogLevelColumnFormatter.__init__)s\ ) A:T..335;KLM J +D DJ!D r)ctt|}|jdn|jj|d}d|t ||j |j dS)NrM[])rr,rogetr(rdra)rQrRrSlevelstyles r'rTz LogLevelColumnFormatter.__call__;shS%   ( ""&&ub1  5'$udjj1243C3C2DAFFr)rr)rodict[str, str]rar,rdz int | NonerWNonerU)r:r;r<rXr=ryrTr>r)r'rmrmsP,(' J ! "$"" "  "$Gr)rmc>|jdt|zy)a "Pretty"-print *exc_info* to *sio* using our own plain formatter. To be passed into `ConsoleRenderer`'s ``exception_formatter`` argument. Used by default if neither Rich nor *better-exceptions* are present. .. versionadded:: 21.2.0  N)rirrkexc_infos r'rrIsIId&x001r)ceZdZUdZdZded<dZded<dZd ed <d Zd ed <dZ ded<dZ d ed<dZ d ed<dZ ded<dZ d ed<dZd ed<dZded<dZded<dZded<ddZy )rag A Rich traceback renderer with the given options. Pass an instance as `ConsoleRenderer`'s ``exception_formatter`` argument. See :class:`rich.traceback.Traceback` for details on the arguments. If a *width* of -1 is passed, the terminal width is used. If the width can't be determined, fall back to 80. .. versionadded:: 23.2.0 truecolorz:Literal['auto', 'standard', '256', 'truecolor', 'windows'] color_systemTbool show_localsdrc max_framesNr^themeF word_wrap extra_linesrd indent_guides locals_max_lengthPlocals_max_stringlocals_hide_dunderlocals_hide_sunderr>zSequence[str | ModuleType]suppressc |jdk(rtjd\|_}|jdt ||j |jj tj||j|j|j|j|j|j|j|j|j |j"|j$|j&d y)N)rrr)filerrd) rrrrrrdrrrrrr)rdshutilget_terminal_sizerirrprintrfrom_exceptionrrrrrrrrrrr)rQrkr_s r'rTzRichTracebackFormatter.__call__us :: "44W=MDJ $4#4#4DJJ %  $ $ ,,??jj.. ,,jj"00"&"8"8"&"8"8#'#:#:#'#:#:  r)rkr rrrWr)r:r;r<rXrr=rrrrrrdrrrrrrrTr>r)r'rrVs  KJE:ItKE3M4ss##$$+-H(- r)rcj|jddjtj|zy)a  Pretty-print *exc_info* to *sio* using the *better-exceptions* package. To be passed into `ConsoleRenderer`'s ``exception_formatter`` argument. Used by default if *better-exceptions* is installed and Rich is absent. .. versionadded:: 21.2.0 rrMN)rijoinbetter_exceptionsformat_exceptionrs r'rrs*IIdRWW.??JKKLr)c eZdZdZeedddedddddf d dZd dZ d d Z e ddd Z y)ra Render ``event_dict`` nicely aligned, possibly in colors, and ordered. If ``event_dict`` contains a true-ish ``exc_info`` key, it will be rendered *after* the log line. If Rich_ or better-exceptions_ are present, in colors and with extra context. Args: columns: A list of `Column` objects defining both the order and format of the key-value pairs in the output. If passed, most other arguments become meaningless. **Must** contain a column with ``key=''`` that defines the default formatter. .. seealso:: `columns-config` pad_event: Pad the event to this many characters. Ignored if *columns* are passed. colors: Use colors for a nicer output. `True` by default. On Windows only if Colorama_ is installed. Ignored if *columns* are passed. force_colors: Force colors even for non-tty destinations. Use this option if your logs are stored in a file that is meant to be streamed to the console. Only meaningful on Windows. Ignored if *columns* are passed. repr_native_str: When `True`, `repr` is also applied to ``str``\ s. The ``event`` key is *never* `repr` -ed. Ignored if *columns* are passed. level_styles: When present, use these styles for colors. This must be a dict from level names (strings) to terminal sequences (for example, Colorama) styles. The default can be obtained by calling `ConsoleRenderer.get_default_level_styles`. Ignored when *columns* are passed. exception_formatter: A callable to render ``exc_infos``. If Rich_ or better-exceptions_ are installed, they are used for pretty-printing by default (rich_ taking precedence). You can also manually set it to `plain_traceback`, `better_traceback`, an instance of `RichTracebackFormatter` like `rich_traceback`, or implement your own. sort_keys: Whether to sort keys when formatting. `True` by default. Ignored if *columns* are passed. event_key: The key to look for the main log message. Needed when you rename it e.g. using `structlog.processors.EventRenamer`. Ignored if *columns* are passed. timestamp_key: The key to look for timestamp of the log message. Needed when you rename it e.g. using `structlog.processors.EventRenamer`. Ignored if *columns* are passed. pad_level: Whether to pad log level with blanks to the longest amongst all level label. Requires the Colorama_ package if *colors* is `True` **on Windows**. Raises: ValueError: If there's not exactly one default column formatter. .. _Colorama: https://pypi.org/project/colorama/ .. _better-exceptions: https://pypi.org/project/better-exceptions/ .. _Rich: https://pypi.org/project/rich/ .. versionadded:: 16.0.0 .. versionadded:: 16.1.0 *colors* .. versionadded:: 17.1.0 *repr_native_str* .. versionadded:: 18.1.0 *force_colors* .. versionadded:: 18.1.0 *level_styles* .. versionchanged:: 19.2.0 Colorama now initializes lazily to avoid unwanted initializations as ``ConsoleRenderer`` is used by default. .. versionchanged:: 19.2.0 Can be pickled now. .. versionchanged:: 20.1.0 Colorama does not initialize lazily on Windows anymore because it breaks rendering. .. versionchanged:: 21.1.0 It is additionally possible to set the logger name using the ``logger_name`` key in the ``event_dict``. .. versionadded:: 21.2.0 *exception_formatter* .. versionchanged:: 21.2.0 `ConsoleRenderer` now handles the ``exc_info`` event dict key itself. Do **not** use the `structlog.processors.format_exc_info` processor together with `ConsoleRenderer` anymore! It will keep working, but you can't have customize exception formatting and a warning will be raised if you ask for it. .. versionchanged:: 21.2.0 The colors keyword now defaults to True on non-Windows systems, and either True or False in Windows depending on whether Colorama is installed. .. versionadded:: 21.3.0 *sort_keys* .. versionadded:: 22.1.0 *event_key* .. versionadded:: 23.2.0 *timestamp_key* .. versionadded:: 23.3.0 *columns* .. versionadded:: 24.2.0 *pad_level* FNTeventr6c ||_||_| gd#fd } |tk7r| d|tk7r| d|dur| d|dur| d|| d|dk7r| d | d k7r| d D]} t j | d | Dcgc]}|j dk(s|}}|s tdt|dkDr td|dj|_ | Dcgc]}|j s|c}|_ y|rtrt9|jj}t!t"j%|dzd|r+tj&tj(dntj(t*}nt,}||_||j1|n|j3}|D]}||xx|j4z cc<tt7|j9d|_||_t?|j@|jB|jD|jFd|_ t?d|j4|jHz|jDtJdd}| sdnd}tM| t?d|jN|jDtJtMdtQ||jD|tM|t?d|j4|jDtJ| tMd!|tMd"|g|_ ycc}wcc}w)$Nc0jd|dy)NzThe `z-` argument is ignored when passing `columns`.)append)argto_warns r'add_meaningless_argz5ConsoleRenderer.__init__..add_meaningless_arg6sC5 MNr) pad_eventcolorsF force_colorsrepr_native_strror event_keyr6 timestamp_key stacklevelrMz>Must pass a default column formatter (a column with `key=''`).rz*Only one default column formatter allowed.rz with `colors=True`colorama)whopackage)stripct|Srrrsrts r'rvz*ConsoleRenderer.__init__..s SVr)rw)rbrdr{r|)r_r`rarbrerf)r_r`rarbr~)rard)r_r`rarbrdloggerr7)rr,rWr))_exception_formatter _sort_keys _EVENT_WIDTH _has_colorswarningswarnrR ValueErrorr"r[_default_column_formatter_columns _IS_WINDOWSr __class__r: SystemError_MISSINGformatdeinitinitr@rL_stylesget_default_level_stylescopyr.r#rx_longest_level_repr_native_strr]r8r9r-_reprr7r,rZr6rm)rQrrrrroexception_formatter sort_keysrrcolumns pad_levelrwcoldefaults classnamestyleslevel_to_colorrRlogger_name_formatter level_widthrs @r'ryzConsoleRenderer.__init__"s,%8!#  G  L(#K0$#H-5(#N3e+#$56'#N3G##K0 +#O4 / aA. /(/@#''R-@H@ T8}q  !MNN-5a[-B-BD *,3?SswwS?DM  # $ 7 7I%  ),A A$.( OO%MM.MMO$F!F #  ) )& 1 $&  " 1C 3 6== 0  1! ##%+; < !0)@ MM OO LLzz * &!8 (:(::  !  )ad  '" & 0 0 & "   '" K  '" & & "#   82 3 ="7 87  SA@sL:0L:4L?L?c|jdur t|St|trt |hdzr t|S|St|S)zj Determine representation of *val* depending on its type & self._repr_native_str. T> r r!"'rh)rrepr isinstancer,set)rQvals r'rzConsoleRenderer._reprsL  D (9  c3 3x@@Cy JCyr)c |jdd}|jdd}|jdd}|jDcgc]F}|j|jtx}tur|j |j|Hc}|j r t |n|D cgc]} |j| || c} z} t} | jdjd| Djd|)| jd|z|s|| jdt|}|r"|j| || j#S|=|jturtj dd | jd|z| j#Scc}wcc} w) Nstack exceptionrr!c3&K|] }|s| ywrrr>).0kvs r' z+ConsoleRenderer.__call__..s32B3srzR =============================================================================== zQRemove `format_exc_info` from your processor chain if you want pretty exceptions.rr)poprrR_NOTHINGr[rsortedrrrirrstriprrrrrrj) rQrname event_dictrexcrrrrRkvsrks r'rTzConsoleRenderer.__call__sw-nn[$/>>*d3}} !~~cggx88I MM#''3 ' /3ooz*:   * *3 3 @  j 388333;;C@A   IIdUl #3? 23'1   % %c8 4||~_((? 5  IIdSj !||~=  s A F7-F<c |rtnt}|j|j|j|j |j |j |j|jdS)a Get the default styles for log levels This is intended to be used with `ConsoleRenderer`'s ``level_styles`` parameter. For example, if you are adding custom levels in your home-grown :func:`~structlog.stdlib.add_log_level` you could do:: my_styles = ConsoleRenderer.get_default_level_styles() my_styles["EVERYTHING_IS_ON_FIRE"] = my_styles["critical"] renderer = ConsoleRenderer(level_styles=my_styles) Args: colors: Whether to use colorful styles. This must match the *colors* parameter to `ConsoleRenderer`. Default: `True`. )criticalrerrorrwarninginfodebugnotset) r@rLr/r0r1r2r3r4r5)rrs r'rz(ConsoleRenderer.get_default_level_styless_&%+ --//''%%((%%''))  r))rrcrrrrrrrornrrrrrr,rr,rzlist[Column] | Nonerr)rrrWr,)rrrr,rrrWr,)T)rrrWr) r:r;r<rXrrdefault_exception_formatterryrrT staticmethodrr>r)r'rrsmb&"" %.21L ('+V V V  V  V , V /V V V V %V V p %#%+.%>*i 0 A!Jz r))r$r,r%rcrWr,r)rrrr,rrrWr)MrX __future__rrsysr dataclassesriortypesrtypingrrr r r r r rr_framesr processorsrrrrrr ImportErrorrrich rich.consolerrich.tracebackr__all__platformrrrr(StylerArBrGForerCrHrIrJrDrEBackrFr _use_colorsr+Stylesr@rLrOrZr]rmrVrrrrrrrrrr>r)r'rs  # !   ',HH$( llg% > ' ((I ^^ " "F ..  C --  C ==  D ==  Dmm##G ]] ! !F MM  E}}  H I F C C D DG F EHo5!5  h" wW % &$$ h *  ( 88 8v5G5Gp 8 2 6 6  6 r()  M"0""2"1[ [ | H  (+9BWH  Ds6H5I I5I?II III