dbus-test-runner(1)

NAME
dbus-test-runner - run multiple tasks under an independent DBus session bus

SYNOPSIS
dbus-test-runner
[ options ]

DESCRIPTION
dbus-test-runner is a simple little executable for running a couple of programs under a new DBus session.

Use this DBus tool for unit testing of code that accesses DBus at runtime.

HELP OPTIONS
dbus-test-runner accepts the following help options on the command line:

\FC-h, --help\F[]
    Display a short help text with application and help command line options and exit.

\FC--help-all\F[]
    Display the full list of available command line options (help, task control, application) and exit.

\FC--help-task-control\F[]
    Display options that are used to control how the task is handled by the test runner.

TASK CONTROL OPTIONS
dbus-test-runner accepts the following task control options on the command line:

\FC-t, --task=<executable>\F[]
    Defines a new task to run under our private DBus session.

\FC-n, --task-name=<name>\F[]
    A string to label output from the previously defined task. Defaults to taskN.

\FC--task-bus={session|system|both}\F[]
    Configures which bus the task expects to connect to. Default: both

\FC-r, --ignore-return\F[]
    Do not use the return value of the task to calculate whether the test passes or fails.

\FC-i, --inverteturn\F[]
    Invert the return value of the task before calculating whether the test passes or fails.

\FC-p, --parameter\F[]
    Add a parameter to the call of this utility. May be called as many times as you'd like.

\FC-f, --wait-for=<dbus-name>\F[]
    A dbus-name that should appear on the bus before this task is started

\FC-c, --wait-until-complete\F[]
    Signal that we should wait until this task exits even if we don't need the return value

APPLICATION OPTIONS
dbus-test-runner accepts the following application options on the command line:

\FC--dbus-daemon=<executable>\F[]
    Path to the DBus daemon to use. Defaults to 'dbus-daemon'.

\FC-d, --dbus-config=<config_file>\F[]
    Configuration file for newly created DBus server. Defaults to '/usr/share/dbus-test-runner/session.conf'.

\FC--bustle-monitor=<executable>\F[]
    Path to the Bustle DBus Monitor to use. Defaults to 'bustle-dbus-monitor'.

\FC-b, --bustle-data=<data_file>\F[]
    A file to write out data from the bustle logger to.

\FC-m, --max-wait=<seconds>\F[]
    The maximum amount of time the test runner will wait for the test to complete. Default is 30 seconds.

\FC--keep-env\F[]
    Whether to propagate the execution environment to the dbus-server and all the services activated by it. By default the environment is cleared.

\FC--bus-type={session|system|both}\F[]
    Configures which buses are represented by the tool to the tasks. Default: session

SEE ALSO
http://launchpad.net/dbus-test-runner

AUTHOR
This manual has been written for the Debian project by Mike Gabriel <mike.gabriel@das-netzwerkteam.de> and may be used by others.