U j@sdZddlmZddlmZddlmZmZmZddl m Z eZ GdddZ e d d d d Z ee ed ddZe ed ddZd S)z Code related to "flattening" events; that is, extracting a description of all relevant fields from the format string and persisting them for later examination. ) defaultdict) Formatter)AnyDictOptional)LogEventc@s:eZdZdZddddZeeeeeedddZdS) KeyFlattenerz A L{KeyFlattener} computes keys for the things within curly braces in PEP-3101-style format strings as parsed by L{string.Formatter.parse}. N)returncCstdd|_dS)z/ Initialize a L{KeyFlattener}. cSsdS)Nrr r r ;/tmp/pip-unpacked-wheel-j5h_c8_q/twisted/logger/_flatten.pyz'KeyFlattener.__init__..N)rkeys)selfr r r __init__szKeyFlattener.__init__) fieldName formatSpec conversionr cCsf|dkr d}|dkrd}dj|||d}|j|d7<|j|}|dkrb|dt|j|7}|S)a Compute a string key for a given field/format/conversion. @param fieldName: A format field name. @param formatSpec: A format spec. @param conversion: A format field conversion type. @return: A key specific to the given field, format and conversion, as well as the occurrence of that combination within this L{KeyFlattener}'s lifetime. Nz%{fieldName}!{conversion}:{formatSpec})rrrr/)formatrstr)rrrrresultnr r r flatKey s zKeyFlattener.flatKey)__name__ __module__ __qualname____doc__rrrrr r r r r sr N)eventr cCs|dddkrdSd|kr&|d}ni}t}t|dD]\}}}}|dkrTq>|dkr`d}||||}|||d}||krq>|dr|dd}d } nd } t|d |} | d } |dkrt} nt} | r| } | | } | ||<| ||<q>|r||d<dS) z Flatten the given event by pre-associating format fields with specific objects and callable results in a L{dict} put into the C{"log_flattened"} key in the event. @param event: A logging event. log_formatN log_flattenedrsrz()TFr r) getr aFormatterparserendswith get_fieldreprr)r fields keyFlattener literalTextrrrZ flattenedKeyZ structuredKeyZcallitfieldZ fieldValueZconversionFunctionZflattenedValuer r r flattenEvent@sB    r0)r/r r cCsXt}td|d\\}}}}|dk s.t||||}d|krLt||d|S)a. Extract a given format field from the given event. @param field: A string describing a format field or log key. This is the text that would normally fall between a pair of curly braces in a format string: for example, C{"key[2].attribute"}. If a conversion is specified (the thing after the C{"!"} character in a format field) then the result will always be str. @param event: A log event. @return: A value extracted from the field. @raise KeyError: if the field is not found in the given event. {}Nr")r r'r(AssertionErrorrr0)r/r r-r.rrrkeyr r r extractField{s  r5c Csn|d}t}g}t|dD]B\}}}}|||dk r ||||pLd}|t||q d|S)z Format an event which has been flattened with L{flattenEvent}. @param event: A logging event. @return: A formatted string. r"r!Nr$r)r r'r(appendrrjoin) r Z fieldValuesr-r$r.rrrr4r r r flatFormats r8)r collectionsrstringrtypingrrrZ _interfacesrr'r r0rr5r8r r r r s   ,;