Installing Winpdb

Activate your Petrel virtual environment and then use pip to install it:

source <virtualenv directory>/bin/activate
pip install winpdb

Add Winpdb breakpoint

In the splitsentence.py file, add the following at the beginning of the run() function:

import rpdb2
rpdb2.start_embedded_debugger('password')

The 'password' value can be anything; this is simply the password that you will use in the next step to attach to splitsentence.py.

When this line of code executes, the script will freeze for a default period of 5 minutes, waiting for a debugger to attach.

Launching and attaching the debugger

Now run the topology:

petrel submit --config topology.yaml

Once you see log messages from the spout, you will know that the topology is up and running, so you can connect with the debugger.

Launch Winpdb simply by running winpdb.

For more details on how to use Winpdb for embedded debugging, see the documentation at http://winpdb.org/docs/embedded-debugging/.

When the window appears, select File...