From: Victor Stinner <victor.stinner@gmail.com>
Date: Mon, 25 Nov 2013 08:40:27 +0000 (+0100)
Subject: Mention the new tracemalloc module in the What's New in Python 3.4 document
X-Git-Tag: v3.4.0b2~492
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=d2736affa1707b0f0d90cc5440d241a52a2704db;p=python

Mention the new tracemalloc module in the What's New in Python 3.4 document
---

diff --git a/Doc/whatsnew/3.4.rst b/Doc/whatsnew/3.4.rst
index af3c35f9ad..9882fdde54 100644
--- a/Doc/whatsnew/3.4.rst
+++ b/Doc/whatsnew/3.4.rst
@@ -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
 ================