U  W[@sZdZddlmZddlmZddlmZeZGdddeZ ddZ d d Z d d Z d 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. ) Formatter) defaultdict)unicodec@s eZdZdZddZddZdS) 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}. cCstdd|_dS)z/ Initialize a L{KeyFlattener}. cSsdS)Nrrrr9/usr/lib/python3/dist-packages/twisted/logger/_flatten.pyz'KeyFlattener.__init__..N)rkeys)selfrrr__init__szKeyFlattener.__init__cCsVdj||p d|pdd}|j|d7<|j|}|dkrR|dt|j|7}|S)a Compute a string key for a given field/format/conversion. @param fieldName: A format field name. @type fieldName: L{str} @param formatSpec: A format spec. @type formatSpec: L{str} @param conversion: A format field conversion type. @type conversion: L{str} @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. @rtype: L{str} z%{fieldName}!{conversion}:{formatSpec}) fieldName formatSpec conversion/)formatr str)r rrrresultnrrrflatKey!s zKeyFlattener.flatKeyN)__name__ __module__ __qualname____doc__r rrrrrrsrcCs|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. @type event: L{dict} log_formatN log_flattenedrsr z()TFrr) getr aFormatterparserendswithZ get_fieldreprr)eventZfields keyFlattener literalTextrrrZ flattenedKeyZ structuredKeyZcallitfieldZ fieldValueZconversionFunctionZflattenedValuerrr flattenEventCs@      r*cCsLt}td|d\\}}}}||||}d|kr@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 L{unicode}. @type field: L{str} (native string) @param event: A log event. @type event: L{dict} @return: A value extracted from the field. @rtype: L{object} @raise KeyError: if the field is not found in the given event. {}r)rr"r#rr*)r)r&r'r(rrrkeyrrr extractFields r.c Csr|d}g}t}t|d}|D]B\}}}}|||dk r$||||pPd} |t|| q$d|S)z Format an event which has been flattened with L{flattenEvent}. @param event: A logging event. @type event: L{dict} @return: A formatted string. @rtype: L{unicode} rrNrr )rr"r#appendrrjoin) r&Z fieldValuesrr'Z formatFieldsr(rrrr-rrr flatFormats  r1N) rstringr collectionsrZtwisted.python.compatrr"objectrr*r.r1rrrrs   /=