]> granicus.if.org Git - python/commitdiff
Mention the new tracemalloc module in the What's New in Python 3.4 document
authorVictor Stinner <victor.stinner@gmail.com>
Mon, 25 Nov 2013 08:40:27 +0000 (09:40 +0100)
committerVictor Stinner <victor.stinner@gmail.com>
Mon, 25 Nov 2013 08:40:27 +0000 (09:40 +0100)
Doc/whatsnew/3.4.rst

index af3c35f9ade118c8f91cf8a15eeb0470316309d7..9882fdde5455548121a10b82fbe808459f8e128e 100644 (file)
@@ -97,6 +97,7 @@ New library modules:
 * :mod:`selectors`: High-level and efficient I/O multiplexing, built upon the
   :mod:`select` module primitives.
 * :mod:`statistics`: A basic numerically stable statistics library (:pep:`450`).
+* :mod:`tracemalloc`: Trace Python memory allocations (:pep:`454`).
 
 New expected features for Python implementations:
 
@@ -400,6 +401,23 @@ deviation of a data series.
       PEP written and implemented by Steven D'Aprano
 
 
+tracemalloc
+-----------
+
+The new :mod:`tracemalloc` module (defined in :pep:`454`) is a debug tool to
+trace memory blocks allocated by Python. It provides the following information:
+
+* Traceback where an object was allocated
+* Statistics on allocated memory blocks per filename and per line number:
+  total size, number and average size of allocated memory blocks
+* Compute the differences between two snapshots to detect memory leaks
+
+.. seealso::
+
+   :pep:`454` - Add a new tracemalloc module to trace Python memory allocations
+      PEP written and implemented by Victor Stinner
+
+
 Improved Modules
 ================