Merge pull request #9156 from Carreau/buildwn

add do_where for PDB, update whatsnew tool.

docs/source/whatsnew/pr/do_where.rst

@@ -0,0 +1,3 b''
+IPython debugger (IPdb) now supports the number of context lines for the
+``where`` (and ``w``) commands. The `context` keyword is also available in various APIs.
+See PR :ghpull:`9097`

docs/source/interactive/reference.rst

@@ -724,6 +724,69 b' how to control where pdb will stop execution first.'
 For more information on the use of the pdb debugger, see :ref:`debugger-commands`
 in the Python documentation.
 
+IPython extends the debugger with a few useful additions, like coloring of
+tracebacks. The debugger will adopt the color scheme selected for IPython. 
+
+The ``where`` command has also been extended to take as argument the number of
+context line to show. This allows to a many line of context on shallow stack trace:
+
+.. code::
+    In [5]: def foo(x):
+    ...:     1
+    ...:     2
+    ...:     3
+    ...:     return 1/x+foo(x-1)
+    ...:     5
+    ...:     6
+    ...:     7
+    ...:
+    
+    In[6]: foo(1)
+    # ...
+    ipdb> where 8
+    <ipython-input-6-9e45007b2b59>(1)<module>()
+    ----> 1 foo(1)
+
+    <ipython-input-5-7baadc3d1465>(5)foo()
+        1 def foo(x):
+        2     1
+        3     2
+        4     3
+    ----> 5     return 1/x+foo(x-1)
+        6     5
+        7     6
+        8     7
+
+    > <ipython-input-5-7baadc3d1465>(5)foo()
+        1 def foo(x):
+        2     1
+        3     2
+        4     3
+    ----> 5     return 1/x+foo(x-1)
+        6     5
+        7     6
+        8     7
+
+
+And less context on shallower Stack Trace:
+
+.. code::
+    ipdb> where 1
+    <ipython-input-13-afa180a57233>(1)<module>()
+    ----> 1 foo(7)
+
+    <ipython-input-5-7baadc3d1465>(5)foo()
+    ----> 5     return 1/x+foo(x-1)
+
+    <ipython-input-5-7baadc3d1465>(5)foo()
+    ----> 5     return 1/x+foo(x-1)
+
+    <ipython-input-5-7baadc3d1465>(5)foo()
+    ----> 5     return 1/x+foo(x-1)
+
+    <ipython-input-5-7baadc3d1465>(5)foo()
+    ----> 5     return 1/x+foo(x-1)
+
 
 Post-mortem debugging
 ---------------------

docs/source/whatsnew/development.rst

@@ -10,6 +10,7 b' This document describes in-flight development work.'
     conflicts for other Pull Requests). Instead, create a new file in the
     `docs/source/whatsnew/pr` folder
 
+
 .. DO NOT EDIT THIS LINE BEFORE RELEASE. FEATURE INSERTION POINT.
 
 
@@ -18,4 +19,3 b' Backwards incompatible changes'
 
 
 .. DO NOT EDIT THIS LINE BEFORE RELEASE. INCOMPAT INSERTION POINT.
-

tools/update_whatsnew.py

@@ -7,6 +7,7 b' whatsnew/development.rst (chronologically ordered), and deletes the snippets.'
 
 import io
 import os
+from glob import glob
 from os.path import dirname, basename, abspath, join as pjoin
 from subprocess import check_call, check_output
 
@@ -20,15 +21,13 b' INCOMPAT_MARK = ".. DO NOT EDIT THIS LINE BEFORE RELEASE. INCOMPAT INSERTION POI'
 
 # 1. Collect the whatsnew snippet files ---------------------------------------
 
-files = set(os.listdir(pr_dir))
+files = set(glob(pjoin(pr_dir, '*.rst')))
 # Ignore explanatory and example files
-files.difference_update({'README.md',
+files.difference_update({pjoin(pr_dir, f) for f in {
                          'incompat-switching-to-perl.rst',
                          'antigravity-feature.rst'}
-                        )
+                         })
 
-# Absolute paths
-files = {pjoin(pr_dir, f) for f in files}
 
 def getmtime(f):
     return check_output(['git', 'log', '-1', '--format="%ai"', '--', f])
@@ -38,7 +37,11 b' files = sorted(files, key=getmtime)'
 features, incompats = [], []
 for path in files:
     with io.open(path, encoding='utf-8') as f:
-        content = f.read().rstrip()
+        try:
+            content = f.read().rstrip()
+        except Exception as e:
+            raise Exception('Error reading "{}"'.format(f)) from e
+
     if basename(path).startswith('incompat-'):
         incompats.append(content)
     else:
@@ -72,4 +75,4 b' for file in files:'
 
 check_call(['git', 'add', target])
 
-print("Merged what's new changes. Check the diff and commit the change.")
  No newline at end of file
+print("Merged what's new changes. Check the diff and commit the change.")