git.notmuchmail.org Git - apitrace/blob - specs/debug.py

   1 ##########################################################################
   2 #
   3 # Copyright 2008-2009 VMware, Inc.
   4 # All Rights Reserved.
   5 #
   6 # Permission is hereby granted, free of charge, to any person obtaining a copy
   7 # of this software and associated documentation files (the "Software"), to deal
   8 # in the Software without restriction, including without limitation the rights
   9 # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  10 # copies of the Software, and to permit persons to whom the Software is
  11 # furnished to do so, subject to the following conditions:
  12 #
  13 # The above copyright notice and this permission notice shall be included in
  14 # all copies or substantial portions of the Software.
  15 #
  16 # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  17 # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  18 # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  19 # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  20 # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  21 # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
  22 # THE SOFTWARE.
  23 #
  24 ##########################################################################/
  25
  26 '''Debugging utilities.'''
  27
  28
  29 import sys
  30 import traceback
  31 import inspect
  32
  33
  34 def excepthook(type, value, tb):
  35         """
  36         Automatically start the debugger on an exception.
  37
  38         See also:
  39         - http://aspn.activestate.com/ASPN/Cookbook/Python/Recipe/65287
  40         """
  41
  42         if hasattr(sys, 'ps1') \
  43         or not (sys.stdin.isatty() and sys.stdout.isatty() and sys.stderr.isatty()) \
  44         or type == SyntaxError or type == KeyboardInterrupt:
  45                 # we are in interactive mode or we don't have a tty-like
  46                 # device, so we call the default hook
  47                 oldexcepthook(type, value, tb)
  48         else:
  49                 import traceback, pdb
  50                 # we are NOT in interactive mode, print the exception...
  51                 traceback.print_exception(type, value, tb)
  52                 print
  53                 # ...then start the debugger in post-mortem mode.
  54                 pdb.pm()
  55
  56 oldexcepthook, sys.excepthook = sys.excepthook, excepthook
  57
  58
  59 def dump(var):
  60         sys.stderr.write(repr(var) + '\n')
  61