summaryrefslogtreecommitdiffstats
path: root/Doc/library/tracemalloc.rst
diff options
context:
space:
mode:
authorVictor Stinner <victor.stinner@gmail.com>2016-12-30 01:15:29 (GMT)
committerVictor Stinner <victor.stinner@gmail.com>2016-12-30 01:15:29 (GMT)
commit771cf898f43a87930d174e7eefbf2acfe1d8443c (patch)
tree0c11226b2e34b3ca07f3331ae1fb7aebc16ddda9 /Doc/library/tracemalloc.rst
parentacc2f74ca991f6579f5b9055dfe885b9a8af4645 (diff)
parent440d70301b396c1546511157119b7e9e575d48c4 (diff)
downloadcpython-771cf898f43a87930d174e7eefbf2acfe1d8443c.zip
cpython-771cf898f43a87930d174e7eefbf2acfe1d8443c.tar.gz
cpython-771cf898f43a87930d174e7eefbf2acfe1d8443c.tar.bz2
Merge 3.5
Diffstat (limited to 'Doc/library/tracemalloc.rst')
-rw-r--r--Doc/library/tracemalloc.rst26
1 files changed, 13 insertions, 13 deletions
diff --git a/Doc/library/tracemalloc.rst b/Doc/library/tracemalloc.rst
index f56f27b..e165669 100644
--- a/Doc/library/tracemalloc.rst
+++ b/Doc/library/tracemalloc.rst
@@ -66,7 +66,7 @@ Example of output of the Python test suite::
<string>:5: size=49.7 KiB, count=148, average=344 B
/usr/lib/python3.4/sysconfig.py:411: size=48.0 KiB, count=1, average=48.0 KiB
-We can see that Python loaded ``4.8 MiB`` data (bytecode and constants) from
+We can see that Python loaded ``4855 KiB`` data (bytecode and constants) from
modules and that the :mod:`collections` module allocated ``244 KiB`` to build
:class:`~collections.namedtuple` types.
@@ -106,8 +106,8 @@ Example of output before/after running some tests of the Python test suite::
/usr/lib/python3.4/urllib/parse.py:476: size=71.8 KiB (+71.8 KiB), count=969 (+969), average=76 B
/usr/lib/python3.4/contextlib.py:38: size=67.2 KiB (+67.2 KiB), count=126 (+126), average=546 B
-We can see that Python has loaded ``8.2 MiB`` of module data (bytecode and
-constants), and that this is ``4.4 MiB`` more than had been loaded before the
+We can see that Python has loaded ``8173 KiB`` of module data (bytecode and
+constants), and that this is ``4428 KiB`` more than had been loaded before the
tests, when the previous snapshot was taken. Similarly, the :mod:`linecache`
module has cached ``940 KiB`` of Python source code to format tracebacks, all
of it since the previous snapshot.
@@ -176,7 +176,7 @@ Example of output of the Python test suite (traceback limited to 25 frames)::
"__main__", fname, loader, pkg_name)
We can see that the most memory was allocated in the :mod:`importlib` module to
-load data (bytecode and constants) from modules: ``870 KiB``. The traceback is
+load data (bytecode and constants) from modules: ``870.1 KiB``. The traceback is
where the :mod:`importlib` loaded data most recently: on the ``import pdb``
line of the :mod:`doctest` module. The traceback may change if a new module is
loaded.
@@ -192,12 +192,12 @@ ignoring ``<frozen importlib._bootstrap>`` and ``<unknown>`` files::
import os
import tracemalloc
- def display_top(snapshot, group_by='lineno', limit=10):
+ def display_top(snapshot, key_type='lineno', limit=10):
snapshot = snapshot.filter_traces((
tracemalloc.Filter(False, "<frozen importlib._bootstrap>"),
tracemalloc.Filter(False, "<unknown>"),
))
- top_stats = snapshot.statistics(group_by)
+ top_stats = snapshot.statistics(key_type)
print("Top %s lines" % limit)
for index, stat in enumerate(top_stats[:limit], 1):
@@ -468,12 +468,12 @@ Snapshot
The :func:`take_snapshot` function creates a snapshot instance.
- .. method:: compare_to(old_snapshot: Snapshot, group_by: str, cumulative: bool=False)
+ .. method:: compare_to(old_snapshot: Snapshot, key_type: str, cumulative: bool=False)
Compute the differences with an old snapshot. Get statistics as a sorted
- list of :class:`StatisticDiff` instances grouped by *group_by*.
+ list of :class:`StatisticDiff` instances grouped by *key_type*.
- See the :meth:`Snapshot.statistics` method for *group_by* and *cumulative*
+ See the :meth:`Snapshot.statistics` method for *key_type* and *cumulative*
parameters.
The result is sorted from the biggest to the smallest by: absolute value
@@ -511,13 +511,13 @@ Snapshot
See also :meth:`dump`.
- .. method:: statistics(group_by: str, cumulative: bool=False)
+ .. method:: statistics(key_type: str, cumulative: bool=False)
Get statistics as a sorted list of :class:`Statistic` instances grouped
- by *group_by*:
+ by *key_type*:
===================== ========================
- group_by description
+ key_type description
===================== ========================
``'filename'`` filename
``'lineno'`` filename and line number
@@ -526,7 +526,7 @@ Snapshot
If *cumulative* is ``True``, cumulate size and count of memory blocks of
all frames of the traceback of a trace, not only the most recent frame.
- The cumulative mode can only be used with *group_by* equals to
+ The cumulative mode can only be used with *key_type* equals to
``'filename'`` and ``'lineno'``.
The result is sorted from the biggest to the smallest by: