Man Linux: Main Page and Category List

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 TASK_ARGS, --task-args=TASK_ARGS
           Colon-separated arguments for the tasks.

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

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

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

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

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

       -e, --stderr
           Print task process stderr.

       -f, --stdout-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 REPORT_DETAIL, --report-detail=REPORT_DETAIL
           Report verbosity (0:nothing, [1:case], 2:task, 3:condition).

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

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

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

       --log=LOG
           Log to specified filename.

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

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

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

       -o, --stdout
           Print task stdout.

       -p PLUGINPATH, --plugin_dir=PLUGINPATH
           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.

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

       -x EXT, --extension=EXT
           File extension for the task files.

AUTHOR

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

COPYRIGHT

       Copyright © 2009 Cleto Martin Angelina

       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.