doc/source/debugging.rst


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

=================
 Debugging Tests
=================

Running tests through testrepository_ makes it difficult to use pdb for
debugging them. oslotest includes ``oslo_debug_helper`` to make using
pdb simpler/possible.

First, add a pdb call to the test code::

  import pdb; pdb.set_trace()

Then run the tests through ``oslo_debug_helper`` like

::

  $ oslo_debug_helper [tests to run]

or

::

  $ tox -e venv -- oslo_debug_helper [tests to run]

.. seealso::

   * https://wiki.openstack.org/wiki/Testr

.. _testrepository: https://pypi.python.org/pypi/testrepository