This class is used for creating reports from data generated by the Profile class. It is a "friend" of that class, and imports data either by direct access to members of Profile class, or by reading in a dictionary that was emitted (via marshal) from the Profile class. The big
| 72 | func_profiles: Dict[str, FunctionProfile] |
| 73 | |
| 74 | class Stats: |
| 75 | """This class is used for creating reports from data generated by the |
| 76 | Profile class. It is a "friend" of that class, and imports data either |
| 77 | by direct access to members of Profile class, or by reading in a dictionary |
| 78 | that was emitted (via marshal) from the Profile class. |
| 79 | |
| 80 | The big change from the previous Profiler (in terms of raw functionality) |
| 81 | is that an "add()" method has been provided to combine Stats from |
| 82 | several distinct profile runs. Both the constructor and the add() |
| 83 | method now take arbitrarily many file names as arguments. |
| 84 | |
| 85 | All the print methods now take an argument that indicates how many lines |
| 86 | to print. If the arg is a floating point number between 0 and 1.0, then |
| 87 | it is taken as a decimal percentage of the available lines to be printed |
| 88 | (e.g., .1 means print 10% of all available lines). If it is an integer, |
| 89 | it is taken to mean the number of lines of data that you wish to have |
| 90 | printed. |
| 91 | |
| 92 | The sort_stats() method now processes some additional options (i.e., in |
| 93 | addition to the old -1, 0, 1, or 2 that are respectively interpreted as |
| 94 | 'stdname', 'calls', 'time', and 'cumulative'). It takes either an |
| 95 | arbitrary number of quoted strings or SortKey enum to select the sort |
| 96 | order. |
| 97 | |
| 98 | For example sort_stats('time', 'name') or sort_stats(SortKey.TIME, |
| 99 | SortKey.NAME) sorts on the major key of 'internal function time', and on |
| 100 | the minor key of 'the name of the function'. Look at the two tables in |
| 101 | sort_stats() and get_sort_arg_defs(self) for more examples. |
| 102 | |
| 103 | All methods return self, so you can string together commands like: |
| 104 | Stats('foo', 'goo').strip_dirs().sort_stats('calls').\ |
| 105 | print_stats(5).print_callers(5) |
| 106 | """ |
| 107 | |
| 108 | def __init__(self, *args, stream=None): |
| 109 | self.stream = stream or sys.stdout |
| 110 | if not len(args): |
| 111 | arg = None |
| 112 | else: |
| 113 | arg = args[0] |
| 114 | args = args[1:] |
| 115 | self.init(arg) |
| 116 | self.add(*args) |
| 117 | |
| 118 | def init(self, arg): |
| 119 | self.all_callees = None # calc only if needed |
| 120 | self.files = [] |
| 121 | self.fcn_list = None |
| 122 | self.total_tt = 0 |
| 123 | self.total_calls = 0 |
| 124 | self.prim_calls = 0 |
| 125 | self.max_name_len = 0 |
| 126 | self.top_level = set() |
| 127 | self.stats = {} |
| 128 | self.sort_arg_dict = {} |
| 129 | self.load_stats(arg) |
| 130 | try: |
| 131 | self.get_top_level_stats() |