U 祡cH)@sdZddlZddlZddlZddlmZddlmZiaddZeddZ d d Z d ddZ d!ddZ d"ddZ edZedZd#ddZddZddZddZdS)$aA collection of functions to summarize object information. This module provides several function which will help you to analyze object information which was gathered. Often it is sufficient to work with aggregated data instead of handling the entire set of existing objects. For example can a memory leak identified simple based on the number and size of existing objects. A summary contains information about objects in a table-like manner. Technically, it is a list of lists. Each of these lists represents a row, whereas the first column reflects the object type, the second column the number of objects, and the third column the size of all these objects. This allows a simple table-like output like the following: ============= ============ ============= types # objects total size ============= ============ ============= 2 560 3 126 4 96 2 66 1 40 ============= ============ ============= Another advantage of summaries is that they influence the system you analyze only to a minimum. Working with references to existing objects will keep these objects alive. Most of the times this is no desired behavior (as it will have an impact on the observations). Using summaries reduces this effect greatly. output representation --------------------- The output representation of types is defined in summary.representations. Every type defined in this dictionary will be represented as specified. Each definition has a list of different representations. The later a representation appears in this list, the higher its verbosity level. From types which are not defined in summary.representations the default str() representation will be used. Per default, summaries will use the verbosity level 1 for any encountered type. The reason is that several computations are done with summaries and rows have to remain comparable. Therefore information which reflect an objects state, e.g. the current line number of a frame, should not be included. You may add more detailed information at higher verbosity levels than 1. N) stringutils) getsizeofc CstjdkrLddg}|ttj<ddg}|ttj<ddddg}|ttj<ddddd dg}|ttj<d dd dg}|tt<d dd dg}|ttj <ddddg}|tt <ddg}|ttj <ddddg}|tt <dS)NicSs dt|S)Nz classobj(%s))repr)cr3/tmp/pip-unpacked-wheel-8ad_c8mj/pympler/summary.py<z'_init_representations..cSsdt|jS)Nz instance(%s))r __class__frrrr@r cSsdt|jS)Nzinstancemethod (%s))rim_funcirrrrDr cSsdt|jt|jfS)Nzinstancemethod (%s, %s))rZim_classr rrrrrEs cSs d|jjS)Nzframe (codename: %s))f_codeco_namer rrrrJr cSsd|jj|jjfS)Nz"frame (codename: %s, codeline: %s))rrco_firstlinenor rrrrKscSsd|jj|jj|jjfS)Nz0frame (codename: %s, filename: %s, codeline: %s))rr co_filenamerr rrrrMs cSs tt|SNstrtypedrrrrSr cSs dt|S)Nz dict, len=%slenrrrrrTr cSs d|jS)Nz function (%s))__name__r rrrrXr cSsd|j|jfS)Nzfunction (%s.%s)) __module__rr rrrrYr cSs tt|Srrlrrrr]r cSs dt|S)Nz list, len=%srrrrrr^r c Ss dt|dt|ddt|S)Nz module(%s)r__file__znameless, id: %d)getattrid)mrrrrascSs tt|Srrsrrrrfr cSs dt|S)Nz set, len=%srr$rrrrgr ) sys hexversionrepresentationstypesZ ClassTypeZ InstanceType MethodType FrameTypedict FunctionTypelist ModuleTypeset) ZclassobjinstanceZinstancemethodframe_dictfunctionZ_listmoduleZ_setrrr_init_representations8sD        r6cCsi}i}|D]N}t|}||krF||d7<||t|7<q d||<t|||<q g}|D]}||||||gqd|S)zSummarize an objects list. Return a list of lists, whereas each row consists of:: [str(type), number of objects of this type, total size of these objects]. No guarantee regarding the order is given. _reprrappend)ZobjectscountZ total_sizeootyperowsrrr summarizeos r?c Csg}tdd|D}tdd|D}t|}|||D]~}||}||}|r|r|||d|d|d|dgq>|r||q>|r>|||d |d gq>q>q>|S)aGet the difference of two summaries. Subtracts the values of the right summary from the values of the left summary. If similar rows appear on both sides, the are included in the summary with 0 for number of elements and total size. If the number of elements of a row of the diff is 0, but the total size is not, it means that objects likely have changed, but not there number, thus resulting in a changed size. css|]}|d|fVqdSrNr.0rrrr szget_diff..css|]}|d|fVqdSr@rrArrrrDsr7)r,r0updategetr:) leftrightresZ right_by_keyZ left_by_keykeyskeyrCrrrrget_diffs    * rMsize descendingcs$g}|D]}|t|qdddgkr>tdtddg}||kr^tdt|dkr|dkr|jd d d q|dkr|jd d d dn@|dkr|jfdd d n |dkr|jfdd d d|d|}|D]}t|d|d<q|ddddgt |S)zFormat the rows as a summary. Keyword arguments: limit -- the maximum number of elements to be listed sort -- sort elements by 'size', 'type', or '#' order -- sort 'ascending' or 'descending' r#rOzinvalid sort, should be one ofZ ascendingrPzinvalid order, should be one ofrcSs t|dSNrr9xrrrrr zformat_..)rLcSs t|dSrRrSrTrrrrr T)rLreversecs|SrindexrTsortZsortbyrrrr cs|SrrWrTrYrrrr rEr)z # objectsz total size) r:r. ValueErrorrrXrZrppinsert _format_table)r>limitrZorderZ localrowsrowZordersrrYrformat_s.  rbTc#sdd}ddtjtjtjdt|}fdd|D}|fdd|D}|D]2}|fd dt||DV|r`|Vd }q`d S) zFormat a list of lists as a pretty table. Keyword arguments: header -- if True the first row is treated as a table header inspired by http://aspn.activestate.com/ASPN/Cookbook/Python/Recipe/267662 =z | r7rI)rHcenterrIcs"g|]}tfdd|DqS)cs g|]}tt|dqS)rE)rr)rBitempaddingrr sz,_format_table...)max)rBcolrfrrrhsz!_format_table..csg|] }|qSrr)rBw)borderrrrhscsg|]\}}t||qSr)r)rBrewidth)justifyrrrhsFN)rljustrdrjustlowerzipjoin)r>headerZvdelimcolsZ colWidthsZ borderlinerar)rlrnrgrr^s,  r^cCs"t||||dD] }t|qdS)zPrint the rows as a summary. Keyword arguments: limit -- the maximum number of elements to be listed sort -- sort elements by 'size', 'type', or '#' order -- sort 'ascending' or 'descending' )r_rZr`N)rbprint)r>r_rZr`linerrrprint_s rxz^<(type|class) '(\S+)'>$z at 0x[0-9a-f]+r7cCszd}t|}|dks|tkr&t|}n8|d8}tt||krNtt|d}t|||}td|}td|}|S)a/Get meaning object representation. This function should be used when the simple str(o) output would result in too general data. E.g. ".r)rrrr_sweep<sr)rNrOrP)T)rNrOrP)r7)__doc__rer&r)Z pympler.utilrrr(r6r?rMrbr^rxcompiler|rzr9rrrrrrrs&-  4" & !