mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-09-30 20:31:52 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 11

bpo-29554: Improve docs for pstat module and profile. (#88) (#227)

Browse source 
Clarify that methods take a string which is interpreted as a regex,
not a regex object.

Also clarify what the old `-1`, `0`, `1` and `2` options were.

(cherry picked from commit 8fb1f6e039)
This commit is contained in:
Berker Peksag 2017-02-22 04:55:33 +03:00 • committed by GitHub
parent e9c0e5559b
commit b067a5eef7
2 changed files with 12 additions and 8 deletions
Download patch file Download diff file Expand all files Collapse all files

7
Doc/library/profile.rst
View file

@ -444,9 +444,10 @@ Analysis of the profiler data is done using the :class:`~pstats.Stats` class.
significant entries. Initially, the list is taken to be the complete set significant entries. Initially, the list is taken to be the complete set
of profiled functions. Each restriction is either an integer (to select a of profiled functions. Each restriction is either an integer (to select a
count of lines), or a decimal fraction between 0.0 and 1.0 inclusive (to count of lines), or a decimal fraction between 0.0 and 1.0 inclusive (to
select a percentage of lines), or a regular expression (to pattern match select a percentage of lines), or a string that will interpreted as a
the standard name that is printed. If several restrictions are provided, regular expression (to pattern match the standard name that is printed).
then they are applied sequentially. For example:: If several restrictions are provided, then they are applied sequentially.
For example::
print_stats(.1, 'foo:') print_stats(.1, 'foo:')

13
Lib/pstats.py
View file

@ -48,11 +48,14 @@ class Stats:
printed. printed.
The sort_stats() method now processes some additional options (i.e., in The sort_stats() method now processes some additional options (i.e., in
addition to the old -1, 0, 1, or 2). It takes an arbitrary number of addition to the old -1, 0, 1, or 2 that are respectively interpreted as
quoted strings to select the sort order. For example sort_stats('time', 'stdname', 'calls', 'time', and 'cumulative'). It takes an arbitrary number
'name') sorts on the major key of 'internal function time', and on the of quoted strings to select the sort order.
minor key of 'the name of the function'. Look at the two tables in
sort_stats() and get_sort_arg_defs(self) for more examples. For example sort_stats('time', 'name') sorts on the major key of 'internal
function time', and on the minor key of 'the name of the function'. Look at
the two tables in sort_stats() and get_sort_arg_defs(self) for more
examples.
All methods return self, so you can string together commands like: All methods return self, so you can string together commands like:
Stats('foo', 'goo').strip_dirs().sort_stats('calls').\ Stats('foo', 'goo').strip_dirs().sort_stats('calls').\