== C tests ==

To run all C tests (assuming the current directory is $top_srcdir):

  make -C tests check-TESTS

To run tests under Valgrind:

  make -C tests check-valgrind

== Twisted tests ==

To run tests using the system avahi, configure with --enable-avahi-tests

To run Twisted tests:

  make -C tests/twisted check-twisted

To run an individual Twisted test:

  make -C tests/twisted check-twisted TWISTED_TESTS=avahi/aliases.py

or:

  cd tests/twisted
  sh tools/with-session-bus.sh --config-file=tools/tmp-session-bus.conf \
        -- python avahi/aliases.py

To run on the real system avahi instead of the mock avahi, set the
SALUT_TEST_REAL_AVAHI environment variable to a nonzero value. E.g.

  SALUT_TEST_REAL_AVAHI=1 make -C tests/twisted check-twisted \
        TWISTED_TESTS=avahi/aliases.py

To run with debug information:

  make -C tests/twisted check-twisted TWISTED_TESTS=avahi/aliases.py \
        CHECK_TWISTED_VERBOSE=1

or:

  cd tests/twisted
  sh tools/with-session-bus.sh --config-file=tools/tmp-session-bus.conf \
        -- python avahi/aliases.py -v

To debug an individual test you can set one of the following env variable:

  * SALUT_TEST_VALGRIND : to run Salut inside valgrind. The report is
    added to tools/gabble-testing.log.
        export SALUT_TEST_VALGRIND=1

  * SALUT_TEST_REFDBG : to run Salut inside refdbg. The report is written
    to tools/refdbg.log. You can change SALUT_WRAPPER to use an alternative
    refdbg and change REFDBG_OPTIONS to set your own parameters. Example:
        export SALUT_TEST_REFDBG=1
        export SALUT_WRAPPER="/path/to/refdbg"
        export REFDBG_OPTIONS="btnum=16"

  * SALUT_WRAPPER="nemiver" : to run Salut inside the graphical debugger
    nemiver. You'll be able to set up breakpoints; then hit the "continue"
    button to launch Salut.