Metadata-Version: 2.1
Name: winpdb-reborn
Version: 2.0.0.dev5
Summary: A platform independent GPL Python debugger.
Home-page: https://github.com/bluebird75/winpdb
Author: Philippe Fremy, Nir Aides
Author-email: phil.fremy@free.fr
License: GNU GPL
Project-URL: Source, https://github.com/bluebird75/winpdb/
Project-URL: Documentation, http://www.winpdb.org/?page_id=5
Project-URL: Tracker, https://github.com/bluebird75/winpdb/issues
Keywords: debugger
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Environment :: Win32 (MS Windows)
Classifier: Environment :: MacOS X
Classifier: Environment :: X11 Applications
Classifier: License :: OSI Approved :: GNU General Public License v2 or later (GPLv2+)
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Software Development :: Debuggers
Classifier: Topic :: Utilities
Classifier: Topic :: Education
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Software Development :: Debuggers
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Education
Classifier: Intended Audience :: Science/Research
Requires-Python: >=3.4
License-File: LICENSE.txt
Requires-Dist: wxpython>=4


*Winpdb Reborn - A GPL Python Debugger, reborn from the unmaintained
Winpdb*

by Philippe Fremy as maintainer, and Nir Aides as initial author

Website: https://github.com/bluebird75/winpdb 

Description
===========

*Winpdb Reborn* is a portable (Windows / Linux) standalone graphical debugger for Python. It focuses on making debugging
easy and does not include any IDE features. It works on both Python 2 and 3 and has very little dependencies (only WxPython for the GUI).

**Features**:

-  graphical interface with stack/variable inspection, breakpoints and more
-  breakpoints: on lines or functions, with possible conditions, load/save breakpoint info
-  multi-threaded debugging
-  smart handling of fork, follow parent or child
-  remote debugging: GUI on one computer, program to debug on another computer with encrypted communication
-  up to 20 times quicker than pdb, the default Python debugger (on which many other debuggers are built)
-  debug PyPy scripts

**Note:** The original Winpdb was no longer maintained since the release v1.4.8 in
2010. I (Philippe Fremy) am providing a maintained version with new
functionality under the *Winpdb Reborn* name.

Requirements
============

Platform supported:

-  Linux
-  Windows XP and above
-  MacOs is probably working but not tested

To run Winpdb Reborn:

- CPython 2.6 or 2.7 and WxPython 3
- or CPython 3.2 or above and WxPython 4

Note that running Winpdb with PyPy is possible, by launching rpdb2.py with pypy and using the winpdb GUI to connect to it.

Winpdb Reborn is NOT compatible with Jython or IronPython.

Release history
===============

Version 1.5.0
-------------

-  First official release by Philippe Fremy
-  Fix support for Python 2.7
-  Drop support for Python 2.5 and WxPython 2.6, min versions are now Python 2.6 and WxPython 3.0
-  rpdb2.py is now compatible with Python 3
-  Add support for PyPy to Rpdb2
-  Can now specify a different Python interpreter for the program under
   debug, allowing PyPy support
-  Avoid crash on Windows when closing debugger
-  Support drag’n drop of files to load source code
-  Add unit-tests and a functional test suite
-  Add a Continuous Integration server with travis CI
-  Can adjust behavior of debugger to activate/deactivate the breakpoint before exit
-  fix for launching Gnome Terminal properly

Installation
============

The standard way to install Winpdb Reborn is with pip, as administrator/root::

    # python -m pip install winpdb-reborn

You must also install the wxPython for your version of Python: 

-  for Python 2, check https://sourceforge.net/projects/wxpython/files/wxPython/
-  for Python 3, wxPython is automatically installed as a dependency with pip

*Winpdb Reborn* is not packaged yet by any linux distro. If your package manager proposes
to install Winpdb, that’s the old unmaintained Winpdb which works neither with Python 2.7 nor with Python 3.

Additional installation methods
-------------------------------

To install from a checkout or from an archive::

    # python setup.py install -f

No install mode
---------------

If you don’t want to install Winpdb Reborn, you can still try it by calling it explicitely with
your program to debug::

    $ python /the/path/to/winpdb.py my_program.py 

Where do the files go ?
-----------------------

The setup script copies rpdb2.py and winpdb.py modules to the Python
site-packages folder. The scripts rpdb2, winpdb are copied to the
Python binaries (scripts) folder. On Linux this folder is usually ``/usr/bin`` 
and is in the path by default. On Windows this folder is ``%PYTHONHOME%\Scripts``,
where you should see a winpdb.exe and rpdb2.exe .


Usage
=====

If you have installed Winpdb Reborn, the simplest way to launch it is::

    $ python -m winpdb my_program.py

or even::

    $ winpdb my_program.py

Find out about the other command-line options with ``–-help`` .

Documentation
=============

Use the ``-h`` or ``--help``  command-line flag for command-line help.

Inside Winpdb/Rpdb2 console, use the ``help`` command for detailed description of
debugger commands.

Online documentation is available at: http://www.winpdb.org/docs

An introduction to Winpdb usage, by Pr Norm Matloff: http://heather.cs.ucdavis.edu/%7Ematloff/winpdb.html

A detailed Winpdb tutorial is also available at: https://code.google.com/archive/p/winpdb/wikis/DebuggingTutorial.wiki

Community
=========

You can ask questions about Winpdb Reborn on the dedicated google group:
https://groups.google.com/forum/#!forum/winpdb

Feel free to raise issues or propose improvements on the Github repository: https://github.com/bluebird75/winpdb/issues
