The oslotest package also distributes a shell file that may be used to assist in debugging python code. The shell file uses testtools, and supports debugging with pdb.
The typical usage to break into the debugger from a running program is to insert:
import pdb; pdb.set_trace()
Within the tox.ini file of your project add the following:
[testenv:debug]
commands = oslo_debug_helper.sh {posargs}
To run with tox:
$ tox -e debug
$ tox -e debug test_notifications
$ tox -e debug test_notifications.NotificationsTestCase
$ tox -e debug test_notifications.NotificationsTestCase.test_send_notification