NAME

       atheist - a general prupose test framework.

SYNOPSIS

       atheist [options] {{directory | file}}

DESCRIPTION

       atheist allows you to specify the behaviour of your tests in a declarative way using many
       data structures (such us Tasks, Conditions, Daemons, etc.) and provides detailed statistic
       results. The main idea is that the programmer may describes the test behaviour in a .test
       file and atheist runs every tests found. It is possible to check and prepare the system by
       writting setup and teardown files that are executed after and before each test.

       Each test is represented by Task object which have many configuration attributes such us
       execution delay, termination signal expected and many others. Tasks have pre and post
       conditions that are been checked at execution time. You may save the test output and
       compose Conditions objects to assure concrete states of the system during the tests
       execution.

       atheist free all resources used by the user automatically at the end of the execution. See
       the Atheist manual for more information about data structures and tools provided by the
       framework.

       This manual page was written for the Debian distribution because the original program does
       not have a manual page. Instead, it has documentation in the GNU info(1) format; see
       below.

OPTIONS

       -a ARGS, --task-args=ARGS
           Colon-separated arguments for the tasks.

       -b PATH, --base-dir=PATH
           Change working directory.

       -C, --clean-only
           Execute nothing, only remove generated files.

       -d, --describe
           Execute nothing, only describe tasks.

       --dirty
           Do not remove generated files after task execution.

       -e, --stderr
           Print task process stderr.

       -f, --out-on-fail
           Print task output only if it fails.

       -g, --gen-template
           Generate a TaskCase file template with default values.

       -h, --help
           Show the help message.

       -i LEVEL, --report-detail=LEVEL
           Report verbosity (0:nothing, [1:case], 2:task, 3:condition).

       -j, --skip-hooks
           Skip _setup and _teardown files.

       -k, --keep-going
           Continue even with failed tasks.

       -l, --list
           Execute nothing, only list tasks names.

       -r RANDOM, --random=RANDOM
           Run taskcases in random order using the specified seed.

       -o, --stdout
           Print task stdout.

       -p PATH, --plugin-dir=PATH
           A directory containing plugins.

       -q, --quiet
           Do not show result summary nor warnings, only totals.

       -s INLINE, --script=INLINE
           Specifies command line script.

       -t, --time-tag
           Include time info in the logs.

       -u, --until-failure
           Repeat test until it fails.

       -v, --verbose
           Incresse verbosity.

       --version
           Atheist version.

       -w WORKERS, --workers=WORKERS
           number of simultaneous Tasks (deafult:1) 0:auto-select.

       -x COMMAND, --exec=COMMAND
           Exec COMMAND like in "Test(COMMAND, shell=True)".

       --case-time
           Print case execution time in reports.

       --cols=WIDTH
           Terminal width (in chars).

       --config=FILE
           Alternate config file.

       --disable-bar
           Don't show progress bar.

       --ignore=PATTERN
           files to ignore (glob patterns) separated with semicolon.

       --log=LOG
           Log to specified filename.

       --plain
           Avoid color codes in console output.

       --save-stdout
           Save stdout of all tasks.

       --save-stderr
           Save stderr of all tasks.

       --notify-jabber=JABBER
           Notify failed tasks to the given jabber account.

       --notify-smtp=MAIL
           notify failed taks to the given email address.

AUTHOR

       Cleto Martín <cleto.martin@gmail.com>
           Wrote this manpage for the Debian system.

COPYRIGHT

       Copyright © 2009 Cleto Martín

       This manual page was written for the Debian system (and may be used by others).

       Permission is granted to copy, distribute and/or modify this document under the terms of
       the GNU General Public License, Version 3 or (at your option) any later version published
       by the Free Software Foundation.

       On Debian systems, the complete text of the GNU General Public License can be found in
       /usr/share/common-licenses/GPL-3.