Metadata-Version: 1.1
Name: rpdb
Version: 0.1.3
Summary: pdb wrapper with remote access via tcp socket
Home-page: http://tamentis.com/projects/rpdb
Author: Bertrand Janin
Author-email: tamentis@neopulsar.org
License: UNKNOWN
Description: rpdb - remote debugger based on pdb
        ==================================
        
        This is essentially a wrapper around pdb that will re-route stdin and stdout to
        a socket handler. By default it opens the debugger on port 4444::
        
            import rpdb; rpdb.set_trace()
        
        But you can change that by simply instantiating Rpdb manually::
        
            import rpdb
            debugger = rpdb.Rpdb(12345)
            debugger.set_trace()
        
        It is known to work on Jython 2.5, Python 2.5 to 3.1. It was written
        originally for Jython since this is pretty much the only way to debug it when
        running it on Tomcat.
        
        After that your script will "hang" when entering set_trace() and the only
        way to get it to continue is to access rpdb using telnet, netcat, etc..::
        
            nc 127.0.0.1 4444
        
        Installation on CPython (standard Python)
        -----------------------------------------
        
            python setup.py install
        
        Installation in a Tomcat webapp
        -------------------------------
        
        Just copy the rpdb directory (the one with the __init__.py file) in your
        WEB-INF/lib/Lib folder along with the standard Jython library (required).
        
        Known bugs
        ----------
          - The socket is now closed properly so you will need to ^C in netcat and ^\
            in telnet to exit after a continue.
          - For some obscure reason, you will need to run continue twice on Jython.
        
        Author(s)
        ---------
        Bertrand Janin <tamentis@neopulsar.org> - http://tamentis.com/
        
        This is inspired by:
        
            http://bugs.python.org/issue721464
            http://snippets.dzone.com/posts/show/7248
        
        
        0.1.3 (2013-08-02)
        ==================
        
         - Remove a try/finally that seemed to shift the trace location (thanks to k4ml@github).
        
        0.1.2 (2012-01-26)
        ==================
        
         - Catch IOError raised by print in initialization, it may not work in some
           environments (e.g. mod_wsgi). (Menno Smits)
        
        0.1.1 (2010-05-09)
        ==================
        
        Initial release.
        
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: ISC License (ISCL)
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX
Classifier: Programming Language :: Python :: 2.5
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.0
Classifier: Programming Language :: Python :: 3.1
Classifier: Topic :: Software Development :: Debuggers
