o b@sdZddlmZddlmZddlmZmZmZddl m Z eZ GdddZ d e d d fd d Z ded e d efddZd e d efddZd 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<eZdZdZd ddZdedeedeedefd d ZdS) 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}. returnNcCstdd|_dS)z/ Initialize a L{KeyFlattener}. cSsdS)Nrr r r 9/usr/lib/python3/dist-packages/twisted/logger/_flatten.pysz'KeyFlattener.__init__..N)rkeys)selfr r r __init__szKeyFlattener.__init__ fieldName formatSpec conversioncCsf|durd}|dur d}dj|||d}|j|d7<|j|}|dkr1|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)r N)__name__ __module__ __qualname____doc__rrrrr r r r r s r eventr NcCs|dddur dSd|vr|d}ni}t}t|dD]Y\}}}}|dur*q|dkr0d}||||}|||d}||vrCq|drQ|dd}d } nd } t|d |} | d } |dkret} nt} | rl| } | | } | ||<| ||<q|r||d<dSdS) 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)rfields keyFlattener literalTextrrr flattenedKey structuredKeycallitfield fieldValueconversionFunctionflattenedValuer r r flattenEvent@sD     r5r1cCsXt}td|d\\}}}}|dusJ||||}d|vr&t||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'rr5)r1rr,r-rrrkeyr r r extractField{s   r9c Csn|d}t}g}t|dD]!\}}}}|||dur1||||p&d}|t||qd|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 fieldValuesr,r#r-rrrr8r r r flatFormats  r=)r collectionsrstringrtypingrrr _interfacesrr&r r5rr9r=r r r r s   ,;